lslocaldisk

使用 lslocaldisk 命令可显示对系统可见的 Amazon Elastic Block Store (Amazon EBS) 受管磁盘 (MDisk)。

语法

阅读语法图跳过直观语法图 lslocaldisk -filtervalueattribute=value-unitbkbmbgbtbpb-filtervalue?-nohdr-bytes-delimdelimitermdisk_idmdisk_name

参数

-filtervalue attribute=value
(可选)指定与指定值匹配的一个或多个过滤器属性的列表;请参阅 -filtervalue? 以了解受支持的属性。仅返回值与过滤器属性值匹配的对象。如果指定了容量,那么还必须包含单位。使用 unit 参数可解释大小或容量的值。
注: 某些过滤器允许您在输入命令时使用通配符。在系统 CLI 中使用通配符时,应该遵循以下规则:
  • 通配符为星号 (*)。
  • 命令最多可包含一个通配符,并且该通配符必须是字符串中的第一个或最后一个字符。
  • 使用通配符时,必须将过滤器条目包含在双引号 ("") 内,如下所示:
    lslocaldisk -filtervalue  "name=md*"
-unit b | kb | mb | gb | tb | pb
(可选)指定 -filtervalue 参数的数据单位。
注: -unit 必须与 -filtervalue 一起使用。
-filtervalue?
(可选)在报告中包含所有有效的过滤器属性。以下过滤器属性对于 lslocaldisk 命令有效:
  • 类型
  • encrypt
  • iops
  • node_id
将忽略使用 -filtervalue? 参数指定的任何参数。

有关过滤属性的更多信息,请参阅-filtervalue 参数的属性

-nohdr
(可选)缺省情况下,将在简明样式视图中显示每个数据列的标题,在详细样式视图中显示每个数据项的标题。-nohdr 参数用于禁止显示这些标题。
注: 如果没有要显示的数据,那么不会显示标题。
-bytes
(可选)指定希望报告将所有容量显示为字节数。未以字节为单位显示的容量值可能会进行舍入。在过滤容量时,使用字节单位 -unit b 进行精确过滤。
-delim delimiter
(可选)缺省情况下,简明视图中的所有数据列都以空格分隔。每列的宽度设置为每个数据项的最大宽度。在详细视图中,每个数据项各占一行,如果显示标题,将用空格来分隔数据与标题。-delim 参数会覆盖此行为。-delim 参数的有效输入为一个单字节字符。如果在命令行中输入 -delim :,那么在简明视图中将用冒号字符 (:) 分隔所有数据项;例如,不会出现列间距。在详细视图中,数据与标题间以指定的定界符分隔。
mdisk_id | mdisk_name
(可选)指定 MDisk 的名称或标识。使用此参数时,将返回特定 MDisk 的详细视图,而忽略 -filtervalue 参数指定的任何值。如果未指定 mdisk_id | mdisk_name 参数,那么简明视图将显示与 -filtervalue 参数指定的过滤条件相匹配的所有对象。

描述

此命令返回系统可视的 MDisk 的简明列表或详细视图。下表提供了可能的输出。
表 1. lslocaldisk 输出
属性
mdisk_id 显示本地 MDisk 标识。
mdisk_name 显示本地 MDisk 名称。
status 显示本地 MDisk 状态(online、offline 或 degraded)。
mode 显示本地 MDisk 方式(ummanaged、managed 或 image)。
mdisk_grp_id 显示本地磁盘所属的 MDisk 组的标识。
mdisk_grp_name 显示本地磁盘所属的 MDisk 组的名称。
容量 显示磁盘的容量。
encrypt 显示磁盘的加密状态。值为 yes 或 no。
fabric_type 显示本地 MDisk 光纤网的类型。该值与 lsmdisk fabric_type 相同。值为:
  • Fibre Channel (fc)
  • sas
  • ebs
  • iscsi
disk_id 显示云提供者(如 AWS)中的磁盘标识(如果有)。
类型 显示本地 MDisk 类型。值为:
  • gp2
  • io1
  • st1
  • sc1
  • standard
node_id 显示与本地 MDisk 相连的节点的标识。
node_name 显示与本地 MDisk 相连的节点的名称。
state 显示本地 MDisk 的状态。值为:
  • available
  • in-use
  • attaching
  • attached
  • detaching
  • detached
  • creating
  • deleting
  • deleted
  • error
iops 显示本地 MDisk 支持的每秒 I/O 操作 (IOPS) 数。对于配置的 IOPS SSD 卷,该值表示针对卷配置的 IOPS 数。对于通用 SSD 卷,该值表示卷的基线性能以及卷累计 I/O 积分以进行脉冲串传输的速率。有关更多信息,请参阅 Amazon EBS 卷类型
zone 显示本地 MDisk 区域。有关区域的更多信息,请参阅 AWS 区域

简明调用示例

lslocaldisk -delim :

生成的输出:

mdisk_id:mdisk_name:status:mode:mdisk_grp_id:mdisk_grp_name:capacity:encrypt:disk_id:type:node_id:node_name:iops:state:zone
0:mdisk0:online:managed:0:mdiskgrp0:1.0GB:no:vol-09d3adff6553b208e:gp2:1:node1:100:in-use:us-west-2b

详细调用示例

lslocaldisk 0

生成的输出:

mdisk_id 0
mdisk_name mdisk0
status online
mode managed
mdisk_grp_id 0
mdisk_grp_name mdiskgrp0
capacity 1.0GB
encrypt no
fabric_type ebs
disk_id vol-09d3adff6553b208e
type gp2
node_id 1
node_name node1
iops 100
state in-use
zone us-west-2b